home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / pcgames / EMERGY / DX5SDK / SDK / SAMPLES / MID2STRM / readme.txt
Text File  |  1997-07-14  |  1KB  |  25 lines
  1. Mid2Strm Sample Readme File
  2. ===========================
  3.  
  4. This sample is related to the mstream sample, and contains a subset of the
  5. functionality of mstream.
  6.  
  7. Mid2strm converts a .mid file (standard midi file) into a format which can
  8. be easily sent to the the midiStreamXxx APIs.  It takes a .mid file as
  9. input, and produces a .mds file as output.  Note that .mds files are not
  10. a standard Windows file format; for example, they can't be played back by
  11. mplayer.  Your application must play the file back by sending the data to
  12. the midiStreamXxx APIs as shown in the mstream sample.
  13.  
  14. The midiStreamXxx APIs expect a buffer containing 3 DWORDs per MIDI event:
  15. the event, the time stamp, and the stream ID.  The mid2strm sample will
  16. create a buffer of this format and store it as a .mds file.  Of course,
  17. the file will be larger than the .mid file.  To save space, you can specify
  18. the -c option.  This specifies that stream IDs should not be included in the
  19. file, compressing the file by 1/3.  This assumes that all stream IDs will be
  20. zero; for most applications, this is sufficient.  Note, however, that the
  21. stream ID DWORD will have to be inserted into the buffer before it is sent
  22. to the midiStreamXxx APIs.
  23.  
  24. Please see the mstream readme file for more information.
  25.